Adds a rectangle to a window’s update region.

OSStatus InvalWindowRect (
    WindowRef window, 
    const Rect *bounds
);

window

A pointer to the window containing the rectangle that you wish to be updated.

bounds

Set this structure to specify, in local coordinates, a rectangle to be added to the window’s update region.

function result

A result code.

DISCUSSION

The InvalWindowRect function informs the Window Manager that an area of a window should be redrawn. The InvalWindowRect function is similar to the InvalRect function, but InvalWindowRect allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so InvalWindowRect does not require the graphics port to be set before its use.

See also the functions ValidWindowRect and InvalWindowRgn.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)